home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / mvp_soft / mvpp24.zip / MVPPAINT.DOC < prev    next >
Text File  |  1996-01-20  |  37KB  |  779 lines

  1.            MVP Paint - 256 Color VGA Image Workshop
  2.                       by David Johndrow
  3.             Copyright 1993-1996 Pod Bay Enterprises
  4.                   An MVP Software Production
  5.  
  6. MVP Paint is shareware.  You may freely try it for no more than 30
  7. days.  If you like it or find it useful, then you must register with
  8. MVP Software.  To "register" a shareware program means to purchase
  9. it directly from the developer.  (Shareware programs are evaluation
  10. versions only, which means you have the right to try them, but after
  11. trying them you must either register them with the author or delete
  12. them from your system.  It is unlikely that anyone will check up on
  13. you, so shareware works because of the honesty of users.)  When you
  14. register you will receive MVP Paint Professional, which includes
  15. many additional features not found in the shareware version.  The
  16. registered version is described below.
  17.  
  18.                     MVP Paint Professional
  19.  
  20. If you wish to continue to use MVP Paint, you must register by
  21. purchasing MVP Paint Professional.  MVP Paint Professional is not a
  22. shareware product.  It is the "big brother" registered version of
  23. MVP Paint, and is commercial only.  MVP Paint Professional includes
  24. a printed manual, free technical support for one year, the MVP
  25. Toolkit, and the Pod Bay Graphics Library.  The toolkit can modify
  26. palettes, convert color images to greyscale images (2 to 64 shades),
  27. display images, downscale images using a sophisticated anti-aliasing
  28. technique, and even turn your image into compilable BASIC, Pascal,
  29. or C code!  This code can then be compiled, or imported into an
  30. existing program.
  31.  
  32. In addition to the toolkit, MVP Paint Professional includes the Pod
  33. Bay Graphics Library.  This library consists of 30 linkable graphics
  34. routines for Pascal and C programmers that provide a quick and easy
  35. way to write graphics programs in VGA mode 19 (320x200x256).  These
  36. routines are fast and provide quick bypass to the .BGI files that
  37. you might otherwise have to load.  The image routines found in these
  38. libraries use images that are created by MVP Paint and have a .VGA
  39. file extension.
  40.  
  41. Here is a list of the routines included in the Pod Bay Graphics
  42. Library: file detection; set display to VGA mode; set display to
  43. text mode; description of returned error code; draw a pixel at
  44. location x,y in the desired color; return the value of the color
  45. located at x,y; draw a line from point a to b in the desired color;
  46. draw a rectangle; draw a circle; draw an ellipse; clear the screen
  47. while in 320x200 VGA mode; load a palette from disk; set the VGA
  48. card to the desired palette; read VGA card to get current status;
  49. save a palette to disk; set the VGA card to an empty palette so that
  50. screen drawing can occur invisibly (necessary for screen fade in);
  51. fade in screen; fade out screen; set new RGB parameters; determine
  52. bitmap variable size of an image; load an image from disk; load
  53. specially condensed graphics files; put image on screen; put partial
  54. image on screen for animation; grab image and place it in a pointer
  55. variable; put an image to the screen without writing color 0 (for
  56. animation over backgrounds); put a compressed image to the screen
  57. for animation; create a dynamic variable that holds a bitmap.
  58.  
  59. For advanced users, the actual source code used for the graphics
  60. libraries is also available.  For a $100 one-time license fee (in
  61. addition to the purchase price for MVP Paint Professional), you will
  62. receive both the Pascal and C source code found in the graphics
  63. libraries.  Payment of the licensing fee not only gets you the
  64. source code, it also gives you a license to use this code in any
  65. application or software package you create.  You may not, however,
  66. sell or distribute the source code files themselves, or source files
  67. modified from the Pod Bay source files.
  68.  
  69. For the low purchase price of $49.95 plus $4.00 shipping (in the
  70. US), you will receive the latest version of MVP Paint Professional
  71. with printed manual and 1 year free technical support, the MVP
  72. Toolkit, and the Pod Bay Graphics Library.
  73.  
  74. To order, call 800-968-9684 toll-free 24 hours a day.  Please have
  75. your Master Card or Visa ready when you call.  Or fill out the order
  76. form in this manual and fax it to: 616-245-3204.  Make sure your
  77. credit card number and expiration date are legible.  Or if you
  78. prefer mail the order form and your check to: MVP Software, 1035
  79. Dallas SE, Grand Rapids, MI 49507-1407.
  80.  
  81. For overseas orders or technical support call 616-245-8376.
  82.    
  83.              How to Register Online and Receive
  84.              MVP Paint Professional Immediately!
  85.  
  86. MVP is pleased that all MVP shareware products can now be registered
  87. online, with immediate download of the registered version.  This
  88. service is available to anyone in the world who has a Master Card or
  89. Visa and can call from a modem.  To register MVP Paint Professional
  90. and download it immediately, or any MVP shareware game, call
  91. InterComm at 1-310-858-6200.  Once you are connected, go to the MVP
  92. section.  There you may download any MVP shareware program free of
  93. charge, or you may order and immediately download any MVP
  94. non-shareware title or registered title.  It's easy and it's fun, so
  95. call today.
  96.  
  97.          Download All the Latest MVP Shareware Games FREE
  98.  
  99. If your favorite BBS doesn't have an MVP file section, then you may
  100. be missing some great shareware.  To get all the latest and greatest
  101. MVP shareware releases, call one of the leading boards listed below,
  102. and check out the FREE MVP file area.
  103.  
  104. In Grand Rapids, Michigan -- Ryan's Bar (616) 456-1845
  105. In Milwaukee, Wisconsin -- Exec-PC (414) 789-4360
  106. In New York, New York -- The Invention Factory (212) 274-8110
  107. In Boston, Massachusetts -- Channel 1 (617) 354-3230
  108. In Kansas City, Missouri -- Sound Advice (816) 436-8029
  109. In Palo Alto, California -- Space BBS (415) 323-4193
  110. In Reston, Virginia -- World Data Network (703) 620-8900
  111.  
  112. Or call Intercomm Online at (310) 858-6200, the new source for
  113. all of MVP's shareware and registered software.
  114.  
  115. Even better, tell your favorite sysop about the MVP Distribution
  116. Network and how he can be assured of getting all of the latest MVP
  117. shareware hits as soon as they are released.  See the SYSOP.DOC file
  118. for details.
  119.  
  120.                       MVP is Now on CompuServe!
  121.  
  122. You can get all of the latest MVP shareware releases, and discuss
  123. MVP titles directly with the authors on MVP's new section on the
  124. world's largest online information network, CompuServe.  Just type
  125. GO MVPSOFT to get to our section!  If you are not a CompuServe
  126. member you are eligible to receive a FREE trial membership,
  127. including software and online time worth almost $55!  That's right,
  128. you get the CompuServe Information Manager software for DOS or
  129. Windows, which normally costs $29.95.  Plus you get a free first
  130. month of online access, worth $9.95.  And to top it off, you get a
  131. usage credit of $15 of additional online time.
  132.  
  133. To take advantage of this free trial membership to the largest
  134. online service in the world, call 800-848-8199.  Ask for rep 671.
  135. And then GO MVPSOFT and talk to the MVP team on CompuServe.
  136.  
  137.        MVP is Now on the Internet and the World Wide Web!
  138.  
  139. You can get all of the latest MVP shareware releases, find out news
  140. of future activities, and give feedback to MVP on the Internet.  To
  141. visit our new home page, just set your WWW browser to this URL:
  142.  
  143.                   http://www.mvpsoft.com
  144.  
  145. While there, you can see descriptions of all our releases, download
  146. the shareware versions with a click of your mouse button, and check
  147. out full color screen shots for all of our games.  Be sure to leave
  148. feedback telling us how you like our page!  
  149.  
  150. If you prefer using direct ftp to get our files, you can find them
  151. at the following sites:
  152.  
  153.                  ftp.mvpsoft.com/pub/mvpsoft
  154.                  ftp.he.net/pub/mvpsoft
  155.                  ftp.uwp.edu/pub/msdos/games/mvp
  156.                  archive.uwp.edu/pub/msdos/games/mvp
  157.  
  158. Users accessing either of the last two sites on this list must
  159. include a dash in front of their email addresses for the password.
  160. Without that dash the software won't give you access.
  161.  
  162. These sites also have many mirrors, so just look for a game site
  163. with an MVP directory, and you'll be assured of getting the best
  164. games around!
  165.  
  166.                          IMPORTANT
  167.  
  168. IF YOU NEED TECHNICAL SUPPORT INSTALLING OR USING THIS PRODUCT, DO
  169. NOT CALL OUR 800 TOLL-FREE ORDER NUMBER.  THIS NUMBER IS FOR ORDERS
  170. ONLY.  THE PEOPLE WHO ANSWER THIS ORDER LINE HAVE NO TECHNICAL
  171. INFORMATION AND WILL NOT BE ABLE TO ANSWER YOUR QUESTIONS.  THEY
  172. WILL SIMPLY REFER YOU TO THIS NUMBER:
  173.  
  174.                          616-245-8376
  175.  
  176. SO PLEASE CALL THIS NUMBER THE FIRST TIME AND SAVE YOURSELF THE TIME
  177. AND TROUBLE OF MAKING TWO PHONE CALLS.  THANKS.
  178.  
  179. MVP Paint is a full-featured graphics workshop.  With MVP Paint you
  180. can easily create or modify graphics or animation files.  It
  181. supports a variety of advanced features, and has been used to
  182. develop two MVP Software games, Sand Storm and Corncob 3D.
  183. Originally created as an in-house game development tool, it has been
  184. tested extensively in real-world applications.  Game designers and
  185. others demanding performance will like its combination of features
  186. and ease of use.
  187.  
  188. IF YOU HAVE PURCHASED MVP PAINT IN A STORE OR FOUND IT ON A CD-ROM
  189. ------------------------------------------------------------------
  190. If you have purchased MVP Paint in a store or other retail setting,
  191. or if you have found it on a CD-ROM, please contact MVP Software at
  192. (616) 245-8376.  Please have the address and phone number of the
  193. CD-ROM publisher, or of the company that has sold it in the retail
  194. store.  If we determine that the company or publisher is
  195. distributing MVP Paint without written authorization from MVP
  196. Software, we will send you a free computer game as a thank-you for
  197. helping us eliminate unauthorized distribution of this software.
  198.  
  199. VENDORS, DISTRIBUTORS, BBS SYSOPS, & CD-ROM PUBLISHERS
  200. ------------------------------------------------------
  201. The shareware version of MVP Paint may be distributed by catalog
  202. shareware vendors and BBS sysops as long as the distribution terms
  203. outlined in LICENSE.DOC are adhered to.  These terms are very
  204. simple, and we encourage BBS and catalog distribution.  UNDER NO
  205. CIRCUMSTANCES MAY MVP PAINT BE DISTRIBUTED IN A RETAIL STORE OR
  206. ENVIRONMENT, OR ON A CD-ROM, WITHOUT WRITTEN AUTHORIZATION FROM MVP
  207. SOFTWARE.  Please see LICENSE.DOC for details.
  208.  
  209.               MVP Paint Professional Order Form
  210.  
  211. YES!  I would like the benefits and increased productivity of MVP
  212. Paint Professional, including the ability to view Super VGA images
  213. in Super VGA mode, the MVP Toolkit, and the Pod Bay Graphics
  214. Library.  Please rush me the entire package by first class mail.
  215.  
  216. Name ______________________________________________________________
  217.  
  218. Address ___________________________________________________________
  219.  
  220. City _______________________________ State ______ ZIP _____________
  221.  
  222. Country (if outside USA) __________________________________________
  223.  
  224. Price of MVP Paint Professional                              $49.95
  225. Shipping and Handling (US)                                     4.00
  226. Shipping and Handling (Canada)                                 5.00
  227. Shipping and Handling (all other countries)                    6.00
  228. Michigan residents add sales tax                               3.24
  229.                                                               -----
  230. Make check payable to "MVP Software"        Total enclosed:  $
  231. Master Card/Visa information (credit card orders only)
  232.  
  233. Card number __________________________________________
  234.  
  235. Expiration date ______________________________________
  236. -------------------------------------------------------------------
  237. VOLUNTARY QUESTIONS:  Please help us determine what features you
  238. ====================  would like in future products.
  239.  
  240. Circle what type of equipment you have:  386  486SX  486DX  Pentium
  241. Circle the speed of your computer(Mhz):  25  33  40  50  66  90  ___ 
  242. Circle any that apply:   Joystick   Mouse   Modem_______   SVGA card
  243.                                                  (speed)
  244.  
  245. Sound Capability:   Adlib   Sound Blaster   SB Pro   SB AWE32
  246.     PC speaker only  Other ____________________________________
  247.  
  248. Where did you get MVP Paint?
  249. Friend   CompuServe   AOL   Prodigy   Channel 1   Invention Factory
  250. World Data Network   Ryan's Bar   Exec-PC   Space BBS   Sound Advice
  251.  
  252. BBS (name): _______________________  phone # _______________________
  253.     address ________________________________________________________
  254.  
  255. Shareware Distributor (name): ______________________________________
  256.  
  257. --------------------------------------------------------------------
  258. Send this order form and your check to:
  259.  
  260. MVP Software, 1035 Dallas S.E., Grand Rapids, MI  49507-1407
  261. Checks must be in US funds and drawn on a US or Canadian bank.
  262.  
  263. US or Canada 24-hour order line: 800-968-9684.  Fax: 616-245-3204.
  264. Tech support, information, or overseas order line: 616-245-8376.
  265.  
  266.                        Ordering Information
  267.  
  268. MVP Paint Professional ver 2.4 is available from the following
  269. authorized distributors:
  270.  
  271. In the United States:
  272. --------------------
  273. MVP Software
  274. 1035 Dallas SE
  275. Grand Rapids, MI 49507-1407
  276. phone: 800-968-9684 24-hour order line only
  277.        (616) 245-8376 information, technical support, or orders.
  278. fax: (616) 245-3204
  279. order price: $49.95 plus $4.00 shipping in the US, $5.00 shipping to
  280. Canada, $6.00 shipping everywhere else.  Michigan residents please
  281. add appropriate sales tax.
  282.  
  283. In Australia:
  284. ------------
  285. Budgetware
  286. 9 Albermarle St
  287. Newtown NSW 2042
  288. phone: (02) 519-4233          Fax: (02) 516-4236
  289. order price: $A69.00 (includes shipping)
  290.  
  291. In the United Kingdom:
  292. ---------------------
  293. Atlantic Coast Plc.
  294. Station Rd.
  295. Colyton, Devon, EX13 6HA
  296. phone: 1297 552222            Fax: 1297 553366
  297. order price: L44 (includes shipping and taxes)
  298. Dealers please enquire.
  299.  
  300. In Denmark and all of Scandanavia:
  301. ---------------------------------
  302. Pro-Soft
  303. Benloese Skel 4 G
  304. DK 4100 Ringsted
  305. phone: 53 61 90 42             Fax: 53 61 93 91
  306. order price: 354,00 kr. + VAT 25% + s/h 25,00
  307.  
  308. In Japan:
  309. --------
  310. P. & A. Company Ltd
  311. 302 Bellwins, 1367-23
  312. Nakagami, Akishima
  313. Tokyo 196
  314. phone: 425-46-9141               Fax: 425-46-9142
  315. BBS: 425-46-9143
  316. order price: 7560 yen includes shipping and taxes
  317.  
  318. Germany, Austria, and Switzerland
  319. ---------------------------------
  320. Topware PD-Service GmbH
  321. Quadrat 0 3, 2
  322. 68161 Mannheim
  323. phone: (0621) 1 26 73 30       Fax: (0621) 1 26 73 33
  324. order price: 79 DM (includes taxes) plus 6 DM shipping
  325.  
  326. The Netherlands and Belgium
  327. ---------------------------
  328. CSD -- Computer Solutions Dorth
  329. Postbus 59
  330. NL-7213 ZH Gorssel
  331. THE NETHERLANDS
  332. phone: (+31)0575.494.545       Fax: (+31)0575.491.222
  333. order price: fl. 112,00 (includes VAT and shipping)
  334.  
  335. Italy
  336. -----
  337. Systems Comunicazioni srl
  338. via Olanda
  339. 6 - 20083 Gaggiano
  340. phone: (02) 9084 1814            Fax: (02) 9084 1682
  341. BBS: (02) 9084 1811
  342. order price: Lire 105.000 IVA inclusa
  343.  
  344. Spain
  345. -----
  346. Friendware S.L.
  347. C/ Miguel Angel, 6 2-5
  348. 28010 Madrid
  349. phone: (91) 308 34 46            Fax: (91) 308 52 97
  350. CIS: 100413,1667
  351. order price: 6.800 Pts
  352.  
  353. GENERAL HELPFUL INFORMATION
  354. ---------------------------
  355. The MVP Paint graphics program is designed to operate stand-alone.
  356. This means that you can install it somewhere on the path and then
  357. call it up by simply typing MVPPaint at any time.  If you are new to
  358. DOS, or if you have no hard drive, you may want to run MVP Paint
  359. from a floppy disk.  The DOS manuals might prove useful for
  360. determining what the path is as well as how to change it, but it is
  361. not necessary to place MVP Paint in the path.  Once the installation
  362. program has copied the MVPPAINT.EXE file and all of the auxillary
  363. files to the desired location, you are ready to run it.  Even though
  364. MVP Paint does not need to be in the current directory, be aware
  365. that all files (palette and image) are loaded and saved in the
  366. current directory.
  367.  
  368. Before running MVP Paint, run CONFIGUR and answer a few questions
  369. about your system.  This will allow MVP Paint to operate in as
  370. efficient manner as possible.
  371.  
  372. To begin the program, type MVPPAINT, and press the ENTER key.
  373.  
  374. MVP Paint may not recognize some really old mouse drivers.  If you
  375. experience an invisible mouse, try getting hold of a newer mouse
  376. driver to correct this problem.
  377.  
  378. FEATURES
  379. --------
  380. All of the feaures included with this program -- line draw,
  381. interpolation, animation, etc., are described and in some cases
  382. illustrated in the online help section.  Before working on your
  383. first image, we recommend that you go through all of the items in
  384. this section to get a good idea about what this program can do.
  385. Note: The animation section is somewhat complicated so in addition
  386. to moving the help for animation into the help section, a
  387. demonstration animation is included with this package.  To see this
  388. demonstration, go to the animation section and choose LOAD and then
  389. choose MVPPAINT.  Then choose VIEW.
  390.  
  391. Experienced users will definitely want to print the list of
  392. available macros.  These macros will greatly speed up the painting
  393. process if used effectively.
  394.  
  395. You can also load files by passing the name as a parameter using
  396. these methods:
  397.  
  398. MVPPAINT V=PARROT - will load the VGA file called PARROT.VGA
  399. MVPPAINT G=PARROT - will load the GIF file called PARROT.GIF
  400. MVPPAINT P=PARROT - will load the PCX file called PARROT.PCX
  401. MVPPAINT C=BW - will load the palette file called BW.PAL
  402. MVPPAINT ? - will remind you of the parameter options available.
  403.  
  404. FILE FORMATS
  405. ------------
  406. File formats be confusing to many users.  In this document, the term
  407. "file format" refers to the disk file that can hold an image, a
  408. palette, or some other entity.  You can discern the nature of a file
  409. by its extensions.  MVP Paint recognizes the following extensions:
  410.  
  411. .GIF - Compuserve format - image file
  412. .PCX - ZSoft format - image file
  413. .VGA - MVP Paint format - image file (compatible w/Borland .BGI drivers)
  414. .PAL - MVP Paint format - palette file
  415. .AF  - MVP Paint format - animation file
  416. .VGR - MVP Paint format - image file (rotated)
  417. .BMP - Windows(r) format - image file
  418.  
  419. THE MENUING SYSTEM
  420. ------------------
  421. MVP Paint's menuing system is icon-based.  This means that general
  422. categories of features are represented by icons, or pictures.  For
  423. example, all file operations are found under the disk icon, all
  424. palette operations under the palette icon, etc.  To choose an
  425. option, just click the left mouse button on an icon.  In some cases
  426. a sub-menu will appear from which you can make a further choice.
  427.  
  428. THE PALETTE SYSTEM
  429. ------------------
  430. The color palette allows you to choose the color in which you want
  431. to perform drawing activities.  Simply point to the color you want
  432. and click the mouse button.  Since only 64 of the 256 colors are
  433. visible at a time, use the arrows on the right side of the palette
  434. to page through the colors.  Also note that in the paint window,
  435. hitting the right button will set the current color to be what was
  436. under the mouse.  If MVP Paint is operating in hidden palette mode,
  437. hitting the right button will return you to normal editing and make
  438. the palette go away.
  439.  
  440. IMPORTANT NOTE
  441. --------------
  442. MVP Paint allows you to work on fullscreen images.  If the image is
  443. too large to allow the menu on-screen, you can bring the menu up by
  444. either hitting the middle button on a three-button mouse, holding
  445. down the right button and then pressing the left, or hitting the
  446. space bar.  Now for the tricky part.  If both the menu and the color
  447. palette are hidden, this action will invoke either depending on the
  448. current location of the mouse.  In the left-half of the screen, it
  449. will call up the color palette, in the right-half it will invoke the
  450. menuing system.  If you are working on an odd-shaped image where one
  451. of those two is already active, say 160x200, then the hidden palette
  452. is invoked regardless of your location at the time of calling.  This
  453. is difficult to describe with words, so give it a whirl and you will
  454. get the hang of it.
  455.  
  456. THE PALETTE EDITOR
  457. ------------------
  458. The palette editor, an extremely useful feature not found in many
  459. paint programs, allows the user to modify the 256 color palette to
  460. contain the 256 colors they want out of a possible 262,144 colors!
  461. In addition to choosing RGB values, other options are available.
  462. Below is a list of the three main operations to perform in the
  463. palette editor:
  464.  
  465. 1. RGB Modification: Click on the desired color you want to modify.
  466.    Then click on the box of the component (red, green or blue) that
  467.    you want to modify.  Then move the cursor up and down until the
  468.    component is set where you want it.  Finally, click the left
  469.  
  470.    button to accept the change, or the right to restore the
  471.    component to its original value.
  472.  
  473. 2. Quick Set: In the color spectrum area (where all 256 colors
  474.    are shown), you choose a color by clicking the left button.  The
  475.    currently chosen color is always outlined by a box.  If you click
  476.    on a color with the right button, and that color is not the
  477.    outlined color, the outlined color will be set to have the RGB
  478.    components of the color you on which you clicked.  This feature
  479.    gives you the means to move colors around or blank them out.
  480.  
  481. 3. Trending: Trending allows you to choose two colors and have all
  482.    of the colors in between them become gradual transitions from the
  483.    first color to the last.  You perform a trend by choosing the
  484.    first color you want and then clicking on "Start Trend." Next,
  485.    choose the last color in the trend and click on "End Trend." Now
  486.    you are ready to click on the "Do Trend" button and watch MVP
  487.    Paint go to work.  Naturally, the farther apart in the palette x
  488.    and y are, the more slight the increments.  You can trend between
  489.    3 colors or all 256!
  490.  
  491. After finishing with the modify palette screen, click on "Quit" to
  492. return to the program where you left off.  You must first tell the
  493. program whether to keep any palette changes made.  Selecting "no"
  494. will return with the same palette as when you entered modify
  495. palette.  Choosing "yes" will make the changes active.  IMPORTANT:
  496. Changes made in the palette are not saved unless you either (1)
  497. choose the palette menu and save the palette in a (.PAL) file or (2)
  498. save the palette with the current image.
  499.  
  500. ANIMATION
  501. ---------
  502. The animation section can be useful to both programmers who want to
  503. test images before devoting time for coding and people who just want
  504. to toy around and have fun.  The basic approach to this animation
  505. section can be likened to film animation.  With a movie, the scenes
  506. are just a long series of still pictures called "frames." Because
  507. image files can get quite large and slow, you wouldn't want to save
  508. the whole screen over and over just to move a space shuttle across a
  509. space scene.  For this reason, you choose a background scene and
  510. then work with all of the elements that will appear within that
  511. scene.  So, in addition to the background, you can choose up to 5
  512. different images to appear over the background within any one frame.
  513. Any one slot within the frame will be referred to as a cell.  Once
  514. all of the cells within a given frame are displayed, the animation
  515. routine will delay an amount of time you specify, and then move on
  516. to the next frame.
  517.  
  518. Just as you load and save image files, you can do the same with
  519. animation files.  This does not save image information but rather
  520. image names, locations, delay times, etc.  An extensive help section
  521. has been implemented in the animation section of MVP Paint.  For
  522. this reason, any further comment here would be redundant.
  523.  
  524. However, one other topic does warrant mention in this document.  In
  525. Frame 1, and only in Frame 1, you can choose for a cell to have
  526. continuancy and thus avoid entering an image that is going to have a
  527. linear path multiple number of times.  Just choose an image as you
  528.  
  529. would normally, choose its location, and then you will return to the
  530. regular animation screen.  Now click the right button on the cell
  531. you want to make continuous.  You will return to the location select
  532. screen once again.  This time, however, you are not entering the
  533. location of the cell but rather the x and y offsets to be used in
  534. each successive frame.  Although this may sound confusing it is
  535. really rather simple.  For an example load the MVPPAINT.AF animation
  536. file.  The shuttle has the continuancy feature associated with it.
  537. To remove this feature from a cell, click the right button a second
  538. time.  Also, remember that it continues only as long as other
  539. animation or delay times continue.
  540.  
  541. PROGRAMMERS' NOTES
  542. ------------------
  543. Here is an example illustrating the VGA file format.  This example
  544. considers an image that is x pixels wide and y pixels high.  Assume
  545. that each of the pixels are identified by the name given to them in
  546. Table 1. Therefore, the pixel located at x=2, y=3 is called 23.  Now
  547. look at Table 2 and you can see how each pixels maps to a
  548. predictable location in the .VGA file!
  549.  
  550.   Table 1:          | 1   2   3  . . .  X
  551.                   --+---------------------
  552.                   1 | 11  21  31 . . .  X1
  553.                   2 | 12  22  32 . . .  X2
  554.                   . |
  555.                   . |
  556.                   . |
  557.                   Y | 1Y  2Y  3Y . . .  XY
  558.  
  559.   Table 2:
  560.   +----------------------------- Offset  0                 (x dimension) - 1
  561.   |       +--------------------- Offset  2                 (y dimension) - 1
  562.   |       |   +----------------- Offset  4                 Pixel 11
  563.   |       |   |  +-------------- Offset  5                 Pixel 21
  564.   |       |   |  |         +---- Offset  3+x               Pixel X1
  565.   |       |   |  |         |     Offset  3+((y-1)*x)+(x-1) Pixel XY
  566.   |       |   |  |         |                                |
  567.   |       |   |  |         |                                |
  568. +--+--+--+--+--+--+--+   +--+--+--+--+     +--+--+--+     +--+   +--+--+-->
  569. |(x-1)|(y-1)|11|21|31|...|X1|12|22|32|.....|1Y|2Y|3Y|.....|XY|...|Palette->
  570. +--+--+--+--+--+--+--+   +--+--+--+--+     +--+--+--+     +--+   +--+--+-->
  571.                                                                    |
  572.                                                                    |
  573. Image Size = ((((x - 1) Div 8) + 1) * 8) * (y-1) + 6  -------------+
  574.  
  575. VGA File Size = Image Size (if palette is not saved)
  576. VGA File Size = Image Size + 768 (if palette is saved)
  577.  
  578. IMPORTANT: MVP Paint does NOT use the Borland VGA256.BGI driver.
  579. This driver has difficulty displaying full-screen images.  We
  580. recommend the SVGA256.BGI driver for better results.  If you wish to
  581. use the VGA256 driver and use Borland putimage routines, you must
  582. first add 1 to each of the dimensions (x and y).  The best
  583. alternative is to avoid the .BGI drivers altogether and use the Pod
  584. Bay Graphics Routines available with the Professional version of
  585. this program.  These routines are lightning fast and will keep your
  586. code size to a minimum.
  587.  
  588. To license source code for the Pod Bay Grapics Library, send $100 to
  589. MVP Software and request the Pod Bay Graphics Library source code
  590. and license.  You will receive the source code in C and Pascal, plus
  591. a license permitting you to use the code in any program -- personal,
  592. shareware, or retail -- that you develop.  However, the license does
  593. NOT give you the right to sell or otherwise distribute the source
  594. files themselves, either in original or modified form.
  595.  
  596. The Pod Bay Graphics Library source code license is available only
  597. to purchasers of MVP Paint Professional.
  598.  
  599. New Features in Version 2.4
  600. ---------------------------
  601. The following is a list of features added for version 2.4 of MVP
  602. Paint.
  603.  
  604. New Features:
  605.     -Directory traversing when loading files
  606.     -Fastgraph (c) fonts now loadable
  607.     -Text/Font Loading now merged, colors changeable within
  608.     -Merge/Blend option to overlay images with translucency
  609.     -Brighten/Darken routines
  610.     -Image Smoothing
  611.     -Image Contrasting (Sharpen or Blur)
  612.     -Windows bitmap file support (.BMP)
  613.     -3D developers file format support (.VGR) (rotated .VGA image)
  614.     -New menu with more logical function groupings
  615.     -Parameter passing refined; easier to use
  616.     -Color fill & replace can use saved images as patterns
  617.     -Palette matching for merge, fill and replace routines (if
  618.      applicable)
  619.     -Tile viewing
  620.  
  621. Bug Fixes, Routine Changes:
  622.     -Random pixel replacement fixed
  623.     -Anti-aliasing lockup fixed
  624.     -Text color 0 (or too dark) now usable
  625.     -Outlining in zoomed mode doesn't leave stray boundaries
  626.     -Phase/Sunburst features always allow up to 99 colors
  627.  
  628. New Feature Descriptions
  629. ------------------------
  630.  
  631. Directory traversing when loading files
  632. ---------------------------------------
  633. Directory names and ".." for changing directories while working in
  634. MVP Paint.  This feature is available in the file load screens for
  635. all file types except animation.  For image files, this feature will
  636. leave you in the directory from which you loaded the file.  This
  637. will ensure that a future save will be placed in the same directory.
  638. When loading a PAL file or merging a VGA file into an existing one,
  639. you can load from other directories, but the current directory
  640. remains the same.  When loading a CHR file (this is a font file),
  641. the routine is the same as with palette files except that instead of
  642. starting in the current directory, MVP Paint first looks in the MVP
  643. Paint directory.  This encourages you to load font files in the MVP
  644. directory and not have to copy them anywhere else!  For loading
  645.  
  646. animation files, you must change to the directory containing the AF
  647. file and run MVP Paint.
  648.  
  649. Merge/Blend option to overlay images with translucency
  650. ------------------------------------------------------
  651. Similar to "Merge File" in that you can use this to merge an image
  652. into the current work image.  Pixels equal to color 0 in the merged
  653. image will not be written.  The big difference is that instead of
  654. using a flat overwrite of pixels from the source to target image, an
  655. approximation pixel is overwritten instead.  The approximation pixel
  656. is calculated by the percentage of the background image you chose to
  657. keep.  The higher the percentage, the more transparent the resulting
  658. image.  The approximation resorts to the target images' palette.  If
  659. the source image has no palette, it is assumed that its palette is
  660. the same as the target.  This feature can be used to create some
  661. really nice special effects!  Note: as with the Merge feature, this
  662. feature only allows importation of 320x200 or less .VGA files.
  663.  
  664. Brighten/Darken routines
  665. ------------------------
  666. You can brighten or darken the entire image, a rectangular region,
  667. or a line within the image.  If you select to modify the whole
  668. image, then the palette is simply modified by the amount you chose.
  669. For example, if you chose to brighten by 8, all RGB components of
  670. the palette are incremented by 8. If you choose a rectangular region
  671. or line, all of the selected pixels are brightened or darkened by
  672. seeking the closest approximation to the current pixel increased or
  673. decreased by the appropriate amount.  For example, color 0, which
  674. usually has RGB components of 0,0,0 will be mapped to the color that
  675. is the closest fit to RGB components of 8,8,8 (If you chose to
  676. brighten by 8).
  677.  
  678. Image Smoothing
  679. ---------------
  680. You can smooth an image using either one of nine available smoothing
  681. methods or a customized version.  You can smooth either the whole
  682. image, the side edges, the top and bottom edges, or all four edges.
  683. You can also select the edge depth and whether or not pixels wrap
  684. around to the other side of the image to compute new values.  This
  685. last feature is of particular use if you are working on tiled
  686. images.  The main feature of this routine consists of a 9x9 grid
  687. with coordinate 5x5 being the center.  This central pixel
  688. corresponds to the pixel to be modified, and the values within the
  689. grid refer to the 'weights' given each relative pixel in the outcome
  690. pixel.  Therefore, if you put a 1 in grid location 5,5, and a 0 in
  691. all other grid locations, there will be no change to your image.
  692. Try loading several smoothing settings and you will see how various
  693. weights effect outcome.
  694.  
  695. Image Contrasting (Sharpen or Blur)
  696. -----------------------------------
  697. Instead of blending pixels for a smoother image, which can be done
  698. with image smoothing, image contrasting, or sharpening, focuses on
  699. the images palette.  You can choose to make colors within the
  700. palette more divergent or convergent.  The former will result in a
  701. crisper, sharper image while the latter will seemingly blur or
  702. "gray" the image out.  After choosing this option, you must select a
  703. divergence factor.  Values less than one result in image blurring
  704.  
  705. while values greater than one will sharpen the image.  You can also
  706. choose to sharpen all of the Red, Green or Blue components at once
  707. or separately.  Most often, you will just want to sharpen the image
  708. in general.  But if, for example, you want to bring out the red in
  709. the image and make it a little stronger, you can choose to just
  710. sharpen reds.  Like image smoothing, this feature is most useful
  711. with digitized images.
  712.  
  713. Windows bitmap file support (.BMP)
  714. ----------------------------------
  715. Now all files can be loaded and saved in the Windows 3.0 and 3.1
  716. uncompressed bitmap (with palette) file format.  EGA bitmaps are not
  717. importable.
  718.  
  719. 3D developers file format support (.VGR) (rotated .VGA image)
  720. -------------------------------------------------------------
  721. If you are developing a 3D game ingine, you might want to avoid the
  722. process of having to rotate all of your .VGA images at runtime.
  723. This feature saves and loads images that are the same as .VGA images
  724. with three exceptions.  First, the image is rotated 90 degrees,
  725. therefore the top of the new image is now what had been the right
  726. side.  3D developers, you'll know why this is necessary!  Second,
  727. for useful purposes, the image size is limited to 200x200.  You
  728. shouldn't need a 3D bitmapped image larger than that!  Third, no
  729. palettes are saved with VGR images.
  730.  
  731. New menu with more logical function groupings
  732. ---------------------------------------------
  733. To improve the logic of using the menu, and to make room for new
  734. features, several changes have been made to the menu.  Most
  735. noticeable will be the new Text and Fx icon buttons.  Other features
  736. have been regrouped with other routines that are similar in nature.
  737.  
  738. Parameter passing refined; easier to use
  739. ----------------------------------------
  740. The parameter passing feature of MVP Paint no longer requires that a
  741. prefix be used for filenames.  File extensions can be ignored if
  742. only one parameter is being passed and that is the name of an image.
  743. MVP Paint will look for the file using the following criteria:
  744.           VGA-> PCX -> GIF -> BMP -> VGR
  745. For example, if you type "MVPPAINT ROSE", and there are files called
  746. ROSE.PCX and ROSE.BMP in the current directory, ROSE.PCX will be
  747. loaded.  If you type "MVPPAINT ROSE.BMP" then ROSE.BMP will be
  748. loaded.  To specify palettes, you must use the file extension.  For
  749. example, "MVPPAINT MYPAL.PAL" will load the palette called MYPAL in
  750. the current directory.  If you type "MVPPAINT ROSE MYPAL.PAL", MVP
  751. Paint will load the ROSE.PCX image, and then load the palette next.
  752.  
  753. Color Fill & Replace can use saved images as patterns
  754. -----------------------------------------------------
  755. The fill and replace routines now allow you to specify a saved image
  756. instead of performing a single color fill.  By choosing "PATTERN"
  757. instead of "COLOR", you will have the opportunity to choose a .VGA
  758. file from the disk drive.  After doing so, the routines will perform
  759. their appropriate functions, but instead of writing a single color,
  760. they will write pixels from the image that you specified.
  761.  
  762. Palette matching for merge, fill and replace routines (if applicable)
  763. ---------------------------------------------------------------------
  764. Often, saved images will have different palettes than the image you
  765. are currently working on.  If you attempt to merge an image with its
  766. own palette, MVP Paint will now ask you if you want to try to match
  767. the incorporated image to the current palette.
  768.  
  769. Tile viewing
  770. ------------
  771. When working on wall or floor tiles for game development, you might
  772. find it useful to see if the edges match up, as well as what the
  773. overall layout would look like.  This feature lets you view your
  774. image with tiles of the same image all around it if it is smaller
  775. than 160 x 100.  For SVGA images, you can view the image in a SVGA
  776. mode if this is the Professional version of MVP Paint.  This option
  777. can be called through the menu or invoked using the Alt-V macro.
  778.  
  779.